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Customer Support 


Thinking Machines Customer Support encourages customers to report errors in Connection Machine 
operation and to suggest improvements in our products. 

When reporting an error, please provide as much information as possible to help us identify and 
correct the problem. A code example that failed to execute, a session transcript, the record of a back¬ 
trace, or other such information can greatly reduce the time it takes Thinking Machines to respond 
to the report. 

To contact Thinking Machines Customer Support: 


U.S. Mail: Thinking Machines Corporation 

Customer Support 
245 First Street 

Cambridge, Massachusetts 02142-1264 

Internet 

Electronic Mail: customer-support@ think.com 


Usenet 

Electronic Mail: ames! think!customer-support 


Telephone: 


(617) 234-4000 
(617) 876-1111 





1 About C*, Versions 6.0 and 6.0.1 


C*® Versions 6.0 and 6.0.1 are the initial release of a new version of the C* data parallel 
programming language. This release supersedes all previous releases of C*. Programs writ¬ 
ten under these releases will not run under the new release. The new release has the 
following goals: 

■ To support data-parallel programming idioms that C programmers can understand 
and use effectively. 

■ To allow efficient access to all user-visible components of the Connection Machine 
system (for example, grid and general communication, scans, spreads, and re¬ 
ductions), so that coding in C* is almost as efficient as coding in the CM’s parallel 
instruction set (Paris). 

■ To allow dynamic behavior. 


2 Versions 

The two versions of C* included in this release differ as follows: 

■ C* Version 6.0 works with Version 5.2 of CM system software. 

■ C* Version 6.0.1 works with Version 6.0 of CM system software. 

Note that C* version numbers do not correspond to CM System Software version numbers. 
There are no differences in these C* versions other than their use with different versions 
of CM system software. Either Version 6.0 or 6.0.1 is installed as the default in your sys¬ 
tem. To use the version that is not the default, specify the -release option when 
compiling, as described in the C* User s Guide. 

Back-compatibility mode is no longer required for C*. 
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ToussAe cpmpiler for the pre-6.0 version of CV issue foe command ocs instead of cs. 
(Check with your system administrator; this version may no longer be available on your 
system.) 


3 Documentation 

The documentation for C* Versions 6.0 and 6.0.1 supersedes all previous C* documenta¬ 
tion. Besides these release notes, it consists of the following: 

■ The C* Programming Guide , which describes how to program in C*. 

■... The C* User’s Guide, which describes how to develop, compile, execute, and 
debug C* programs on a Connection Machine system. 

In addition, a technical report that provides a reference description of the C* language will 
be available separately. Please note that this technical report includes descriptions of fea¬ 
tures of the language that are currently unimplemented; these features are listed in Section 
4, below. 


4 Unimplemented Features 

i-;'- • ■ 

The following features of C* and ANSI C have not yet been implemented: 

■ safety checking 

■ parallel bit fields 

*, parallel enumerated types 

■ the physical_index function 
“ assertion grammar 

■ non-constant subscripts for array declarations 
B const and volatile 
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scalar versions: ofithe bbolepy, boolmove, boolset, and boolcap functions! 


trigrams " 
shape axis alignment 


v ds'rfr ilotdD) 
jns lavs 


In addition, please note that each dimension of a shape must be a power of 2, and the total 
number of positions in the shape must equal the number of physical processors in the CM, 
or be a power-of-2 multiple of this machine size. 
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4.1 Front-End C Compilers Are Not ANSI 
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The C* compiler works with the C compiler on your VAX or Sun front end. Currently, these 
compilers (in particular, their C pre-processors) do not conform to the ANSI standard for 
C. This means that you may be unable to take advantage of certain features of C that are 
new to the ANSI standard—for example, ANSI libraries. When compliant compilers are 
released, these features will be available. 


nxs; 


,no;.ttbb:J al 


This restriction does not apply to function prototyping, which is^'cuffently avai 4 " 


ri 


through the C* compiler. 


yt* .C^lTTi ?-dl IO 




5 Restrictions 



This section discusses known restrictions in the Version 6.0 and 6.0.1 release of C*. 

• i" : ’ ■ f i- . ■ " ycr-vcllof sriT 

’ 'of ;.rr,c; ■ 

5.1 Programs Can Become Too Big for the VAX Compiler 

On a VAX, compiling a C* program may result in one of the following error messages: 


Out of temporary strings space 
btw: Branch too far: Try -J flag 
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The problem is that the . .c file produce by the.: cs Qompi|ef}|stob dargefor the VAX C 
compiler. (Using the -J flag won’t help if you receive the latter message.) The workaround 
is |o fef0^k#p your source file into smaller files. Also, if you h§ye long functions in your 
prograoktrysplitting them up into smaller functions* . yi'^c x o . i 


*770 


5.2 The rank Function Doesn’t Work with a Segment Bit 

The rank function in the communication library currently does not aeeept-a segfnent bit 
for an argument. Specify either CMC_start_bit or CMC_none instead. 

PSfV i> Ivl-C • d. 'y r £i.'. w'i 

xonx •' ' ; s: '~nw .) oi • 

5.3 The write_to_pvar Function Doesn’t Work with bools 

The write_to_pvar function in the communication library currently does not work cor¬ 
rectly when the front-end data to be written is .an array of bools. 


' tf* «Va{. 

i.. 
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5.4 Grid Communication Functions Limited to 128 Bits 

The grid communication functions have versions with a length argument that Jet you 
transmit data of any length. In the current version, the length argument must be 128 bits 
or less. The affected functions are listed below: 

-wolloi sn: , v /c..:.. • - I sir v^orr J: ■■*.:( Vnq *r: o/utots fev' 

from_grid 

f r om_gr i d_dim 

to_grid 

to_grid__dim 

fronMtorus 

f r om_torus_dim 

to^torus 

to torus dim 
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5.5 Incorrect^ne'NumbersP * * - ^ n;h - «rr 

fi , JS &3' ~a s«. /»•*". *>• • . .. . ■■ ■ v- , ij qifgUi .isqqraCK’ 

Infrequently, intebrrfect #li*e directives wiH‘appear in the intermediate . c fife.Sii£nla!r% 
the line number may occasionally be‘incorrect in error messages from th61febffipilbfc?° 1v I 


We would appreciate hearing from you if you run into either of these problems. 


■ Jns-r s itfrh ;V : A-;-* . £.3 

5.6 Problem with Error Recovery i it rr 

'iru -. :>.i rdf 

Occasionally the compiler will find an error in a program, print a message, and then be 
unable to continue processing the program. Instead, it reports an internal compiler error. 

We would appreciate hearing from you if you run into either of these problems. 

vj.Cod J :rn •: j ' rulii: 3f!” c.S 

c ' > r ~ \ i.? r . i ‘"-P w ::; *d 7 . r' - :* rf- t .. 

5.7 Negation of Unsigned Constants 


v cc^e; 1 rrv zdT 

C!-2'?£TCr. SCT ilS.CTV 


The compiler incorrectly optimizes the following code: 


unsigned*u; 


float fr 


S. £► I* 


,/VL A j 4 "•* 

• »*: . v ? ■ »•• , v 


i:tr m;«nmoO Jhw 




r;ov rih -iv>s w : •i?,. .;-i hhg srfX 

?ito f." u ■. -.'r< J -it * ;• r \- , 't.o aiEti Jirnacjixr 

v-.(; ■ :o; . . ^e'.ts .>rfi* .aaai. ro 

To work around the problem, do not negate the unsigned constant. Instead, do the follow- 
ing: hi:. 2 ti ^ '4io:r 1 


u = 200; 
f = -200; 


irsoxSt 

zirzob jj.oxrb 

Xxi: jxob oj' 
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5.8 ; $nn’tR@etefi£ie art enurii Constant in.anlnnerScope 

An enum constant cannot be re-used as an identifier in a places where the enum definition 

is For example, the compiler currently producfs a t syntax ,en;pj ftp the; following 

legal C code: •riwafic \ x- x-rn & 


enum enuma { a }; 
mainO 

{ k& 

int a; 


The workaround is to use different hames. 


c-i -iguo .ill 


Parallel Variable Declarations 5s n ' isles 

Whfen tesirig a shape^altied expression in deelaiing multiple parcel variables, note &at 
the expression isiiKXmtcfiy te-evaflra’ted for each parallel variable; For example? ,s ? * r 

int: (s ()) i, j; '' 

.... ^ 

If s () has side effects, i and j may not be allocated in the same shape., . ’ 

The workaround is to assign the result of the function to a temporary shape, and declare 
the parallel variables to be of this shape. For example: 


shape t = s () ; , f ;i - 

{ 

int:t i, j; 

} . , .... 

•'‘fsom.s- ■> • "in QO" It A >l?£'.‘ • '• ^ “ OX 2 ~’OC ■ W OJ 5n< 1 
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5.10 ‘ Short-circuit 11 Operators Complain about Gonst^nt 54 
Expressions They Shouldn’t Reach 

.. r rum a reoctq :: \ i±k ’>itinia qJi 

The compiled^ialuates ddnstairit expressions it shoultkrtrehch in opeiatbrs lil&tf li a^&£- 
For example, the following line of code: • : '- 5 ' 

int i = 1 | | 2/0; ' " r “ ,riViX -' 

produces the error message 

bad constant expression 

even though the compiler should not evaluate the,expression,2/0 ? M , ? j . 0 3f rq 


5.11 As^igBMi^aftA4#^.s^t.aicalsi;^rfiaj6tS'va^qin1er*c!} 

a Scalar Array ?<-!£%; ishsC p'dernsV mt 

Asgi^iiE^ .|hi||fd^ress*of an arraj^to agoj^er to a sc^l^ aiyay pijoduGes a /segnientatipn 
fault at run time^ For example, t^ following-legal code do?? tpteipTei|tly wprfe^v. , ;i g 


main () 
{ 


int i ; 
int b[2] 




oiE f asif ES.~ * A jlskJ i qm 


a = &b ; 


f bUJ&jOlfa VO 

t o:;u 1 

-s & i,s 

tamest sd:' 

■o ill ;’» ogr 

Oi :.j i>.ii?0'SS3 , -iOW 3i' 

lot 

T.'tfe : "to ■ 

1? *vldf«hs* iml&sq t 


i = (*a)[0] ; 

} 


For this code to work, compile the program with -oO to turn off optimization. 
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|.12 Warning Message when a Paraltel Function Does Not 
Retum a Value .’ 

When a parallel function does note return a value, the compiler generates a warning mes¬ 
sage like the following: 

"(null)", line 0: warning: CMC_return_val not required in func¬ 
tion foo 

You can ignore this message. 


6 Documentation Errors 

6.1 Incorrect Description of send Function 

The description of the parameters of the send function in Section 14.34, page 217, of the 
C* Prograjnming Guide, states the source is a scalar pointer to a parallel variable. In fact, 
it is a parallel variable! The definition at the beginning of the section and the examples later 
in the section are correct. 


7 Programs 

Sample C* programs are available on line. Consult your system administrator for their 
location on your system. 






Supplement to the C* Release Notes, 
Versions 6.0 and 6.0.1 


The restrictions listed below were uncovered too late to be included in the Release Notes 
for C*, Version 6.0 and 6.0.1. Please add this sheet to the Release Notes. 


Send Operations with Wrapping May Produce Incorrect Results 

If you want to use a left-indexed send operation with wrapping (using pcoord and the %% 
operator), make sure that the second operand of the %% operator is equal to the number of 
positions in the dimension (for example, by using the dimof function). Using this syntax 
with other values may produce incorrect results. For example, the following code produces 
incorrect results if n is not equal to the number of positions in axis 1: 


int n; 

/* _ */ 

[.][(. + 1) %% n] a = a; 


The workaroundis to _ _ 

munition library to do the send^jlfi&illy. 




Not D e a ll&esftecf aft© r g oto ,~eontihue, 
toreaKrdrr^Uf n^Statement 


>ihapesaUoc^id wdthm l^nction the function 

via a s#l^£i£8ftftiimenU ! 6r the block Via at goto, cdntiiiSe, orbawMk Statement. This 
could egflMapffdjgram to"¥un out of W Sets. One woiiaround is to'lifficftfre your code So 
that it ekits anjfcblofek of function coiftSffifigl&cal shiperdeclamdBiis tBfpugh the bottoift; 
another is to ipOve the shape declarifibn out of the function or block. 
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